Open the Portico Schema site
Portico Developer Guide
Release Notes

This table contains detailed changes to the current version of the document. For information on past changes, see the Release Notes in that version.

Documentation Section / Topic Change Description
Portico Developer Guide

Updated release version number from 3.48 to 3.52.

Updated release date from October 2025 to May 2026.

Updated branding and copyright, and throughout the document.

General Updates

Replaced most instances of Heartland and HPS with Global Payments.

GSAP-NA

Added a new bullet entry describing ReversalReasonCode for GPN-Mexico FEVO merchants.

GSAP-AP

Added a new bullet entry describing the use of the AllowPartialAuth indicator regarding partial approval support.

Bill Payment

Modified to include Discover.

EMV

Modified to include additional supported transactions.

Fleet Card Processing

Added a new topic on fleet card processing for Canadian merchants using the GSAP-NA authorization platform.

Level III

Updated to indicate that GSAP-NA authorizations must be added to the batch prior to sending the CPC Edit.

P2PE

Added a new topic.

Reversals

Added ARPCCRYPTOGRAMFAILURE as a valid reversal code for DebitReversal requests.

Optional POS Data

Corrected a spacing error in the paragraph..

Sub-Merchant Integrations

Changed unique DeviceID to individual DeviceId for clarity.

Service Location and Geographic Coordinates

Modified Geographic Details to indicate these are now also sent to the Exchange host for Mastercard transactions.

Services That Support EMV Tags

Modified to include additional services that support the passing of EMV tags.

Thank You Points

Added discount amount.

Transaction Link Identifier

Modified text to indicate how Portico handles this on behalf of the merchant.  Noted the TxnLinkIdentifier is now included in the POS response.

Appendices

Added new sections for Fleet Product Codes.

Fleet Prodcut Codes

Added new section.

Glossary

Modified Transaction Link Identifier glossary entry noting the change to a 22-character alphanumeric value from a 36-character indeintfier.

Schema

Updated schema for v3.52